MLBB API Web v4.0.8
MLBB Card Install OpenMLBB Tutorial GitHub Stars
Home User MLBB Academy Addon

OpenMLBB SDK Docs

OpenMLBB Endpoint

SDK call mapping, request requirements, and Python example.

Every card documents the SDK call from OpenMLBB and mirrors API path/query/body requirements.

Jump to SDK endpoint

GET /openmlbb/mlbb/heroes GET /openmlbb/mlbb/heroes/rank GET /openmlbb/mlbb/heroes/positions GET /openmlbb/mlbb/heroes/{hero_identifier} GET /openmlbb/mlbb/heroes/{hero_identifier}/stats GET /openmlbb/mlbb/heroes/{hero_identifier}/skill-combos GET /openmlbb/mlbb/heroes/{hero_identifier}/trends GET /openmlbb/mlbb/heroes/{hero_identifier}/relations GET /openmlbb/mlbb/heroes/{hero_identifier}/counters GET /openmlbb/mlbb/heroes/{hero_identifier}/compatibility

GET Hero Detail Statistics

/openmlbb/mlbb/heroes/{hero_identifier}/stats

Open Only This

API Path: /api/heroes/{hero_identifier}/stats

Get detailed statistics for a specific hero by ID or name. Supports query parameters for rank tier, pagination, and localization.

Path parameters:

  • hero_identifier: Hero identifier as numeric hero ID or hero name. Accepts values like 30, Yi Sun-shin, or yisunshin.

Query parameters:

  • rank: Rank filter. Allowed values: all, epic, legend, mythic, honor, glory.
  • size: Number of items per page (minimum: 1).
  • index: Page index (starting from 1).
  • lang: Language code for localized content (default: en).

The response includes hero statistics:

  • records: Array of hero entries, each containing:
      • _id: Unique record identifier.
      • _createdAt: Creation timestamp.
      • _updatedAt: Last update timestamp.
      • data:
          • main_hero:
              • data:
                  • head: Hero portrait image URL.
                  • name: Hero name.
          • main_heroid: Hero ID.
          • main_hero_channel:
              • id: Channel ID reference.
          • main_hero_appearance_rate: Hero pick rate (appearance frequency).
          • main_hero_ban_rate: Hero ban rate.
          • main_hero_win_rate: Hero win rate.
          • sub_hero: Array of synergy heroes, each containing:
              • heroid: Sub-hero ID.
              • hero_win_rate: Sub-hero win rate.
              • hero_appearance_rate: Sub-hero pick rate.
              • increase_win_rate: Impact of sub-hero on win rate.
              • hero_channel:
                  • id: Channel ID reference.
              • hero:
                  • data:
                      • head: Sub-hero portrait image URL.
              • min_win_rate6: Win rate in matches ≤ 6 minutes, (min_win_rate6*100%).
              • min_win_rate6_8: Win rate in matches 6-8 minutes, (min_win_rate6_8*100%).
              • min_win_rate8_10: Win rate in matches 8-10 minutes, (min_win_rate8_10*100%).
              • min_win_rate10_12: Win rate in matches 10-12 minutes, (min_win_rate10_12*100%).
              • min_win_rate12_14: Win rate in matches 12-14 minutes, (min_win_rate12_14*100%).
              • min_win_rate14_16: Win rate in matches 14-16 minutes, (min_win_rate14_16*100%).
              • min_win_rate16_18: Win rate in matches 16-18 minutes, (min_win_rate16_18*100%).
              • min_win_rate18_20: Win rate in matches 18-20 minutes, (min_win_rate18_20*100%).
              • min_win_rate20: Win rate in matches ≥ 20 minutes, (min_win_rate20*100%).
          • sub_hero_last: Array of negative synergy heroes, each containing:
              • heroid: Sub-hero ID.
              • hero_win_rate: Sub-hero win rate.
              • hero_appearance_rate: Sub-hero pick rate.
              • increase_win_rate: Negative impact on win rate.
              • min_win_rate6 through min_win_rate20: Win rate breakdown across match durations.

This endpoint is useful for:

  • Analyzing hero performance trends across different ranks.
  • Tracking pick, ban, and win rates.
  • Understanding synergy with other heroes.
  • Identifying counters and negative synergies across match durations.

Python Example

from OpenMLBB import OpenMLBB

client = OpenMLBB()
response = client.mlbb.hero_stats("miya", rank="all", size=20, index=1, lang="en")
print(response)

Path and Query Parameters

Name In Type Required Default
hero_identifier path string yes -
rank query string no all
size query integer no 20
index query integer no 1
lang query string no en